hfStatsR Documentation

Statistical plots of U–Pb ages or Hf isotopic parameters

Description

Plots a boxplot or stripplot for a given isotopic parameter, respecting groups.

Usage

hfBoxplot(what = NULL, varwidth = TRUE, cex.axis = 1, col = "lightblue", 
    horizontal = TRUE, xaxs = "i", ...)

hfStripplot(what = NULL)

Arguments

what

the variable name; see Details

varwidth

logical, should be the boxes drawn with widths proportional to the square-roots of the number of observations in each of the groups?

cex.axis

numeric; the relative size of the axis annotation relative to the current setting of cex

col

plotting colours

horizontal

logical; should be the boxplots horizontal?

xaxs

character; the style of axis interval calculation to be used for the x-axis. Possible values are "r", "i", "e", "s", "d". See par

...

Additional parameters to the function boxplot

Details

The boxplot (or box-and-whisker plot) has been designed by Tukey (1977) to portray faithfully a statistical distribution of univariate data. The box represents, for each of the groups, the two quartiles, the line inside is a median, the whiskers span the whole range without outliers. The outliers themselves are shown by small circles.

hfBoxplot.png

Stripplot (Esty & Banfield 2003) shows 1D scatter plots for each of the groups, with some artificial noise (jitter) added to make the individual points better visible. Stripplots are a good alternative to boxplots when sample sizes are small.

hfStripplot.png

The variables to choose from are:

Menu item Explanation
Age (Ma) U–Pb ages
176Hf/177Hfi Initial Hf isotopic ratios
EpsHfi Initial ε(Hf) values
HfTCHUR.1stg Single-stage CHUR Hf model ages
HfTDM.1stg Single-stage DM Hf model ages
HfTDM.2stg Two-stage DM Hf model ages

These can be specified also upon the function call, as the parameter 'what'. The possibilities are 'Age (Ma)', '176Hf/177Hfi', 'EpsHfi', 'HfTCHUR.1stg', 'HfTDM.1stg' or 'HfTDM.2stg'.

Value

For boxplot, a list object with data produced by the function 'boxplot'.

Plugin

Hf.r

Author(s)

Vojtěch Janoušek, vojtech.janousek@geology.cz

References

Esty WW, Banfield JD (2003) The box-percentile plot. J Stat Softw 8: 1–14. doi: 10.1016/j.gsf.2019.09.004

Spencer CJ, Kirkland CL, Roberts NMW, Evans NJ, Liebmann J (2020) Strategies towards robust interpretations of in situ zircon Lu–Hf isotope analyses. Geosci Front 11:843-853. doi: 10.1016/j.gsf.2019.09.004

Tukey JW (1977) Exploratory Data Analysis. Pearson, Reading, MA, pp 1–712

See Also

boxplot, stripplot, hfViolinplot, hfHist

Examples

sampleDataset("khantaishir_Hf")
groupsByLabel("sample")    
    
hfBoxplot("Age (Ma)")

hfBoxplot("EpsHfi")
    
hfBoxplot("HfTDM.2stg", col = heat.colors(5))

hfStripplot("EpsHfi")
    
hfStripplot("HfTDM.2stg")